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FORECAST SUPPORT GROUP VARIABLE NAMING 
CONVENTIONS AND DATA BANK DIRECTORY 

This document first details the data bank and variable naming 
conventions adopted by the Forecast Support Group (FSG) of the Commodity 
Economics Division, ERS to facilitate its data related operations on the 
Wharton Econometric Forecasting Associates/Boeing Computer Services, Inc. 
(WEFA/Boeing) System and then provides a directory of the variables 
currently residing on its banks. Computer operations are preformed via 
telephone data terminals or the ERS dialup remote batch unit, which access 
the Boeing IBM 370/168 computer in McLean, Va. The data is also available 
on the DIS BAttraree Contact the Data Services Division for access to the 
data at WCC. 

The data being placed on the WEFA/BOEING System are comprised 
essentially of U.S. domestic prices and supply and disappearance statistics 
and other statistics to support the FSG models. Emphasis is being placed 
on collection of U.S. aggregate statistics with state, region, and city 
data placed on the system as required for empirical work. Specialized data 
for analytical support of individual program areas within CED has also been 
loaded into the system. Foreign data has been placed on the banks only on 
an as needed basis. 

The FSG is differentiating its data as to frequency and history or 
forecast. Frequency refers to the number of observations per year (i.e., 1 
= annual, 4 = quarterly, 12 = monthly). An annual historic data bank as 
well as quarterly and monthly historic data banks have been created. 

Annual and quarterly U.S. forecast data banks have been created for 


quarterly memo, and contingency analysis, model, futures price, and 
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estimates committee price, supply and disappearance forecasts. Note that 
as new statisitics are placed on the banks for which specific naming 
conventions have not been auticipated, new codes will be identified 
following the same procedures as outlined herein. Thus, this document will 
be periodically updated to keep interested individuals up-to-date on our 
naming conventions. It is anticipated that this coding structure will form 
the basis for a more generalized and comprehensive set of naming 
conventions for ERS and that the variable codes for the data herein will be 
modified to conform to the ERS naming conventions. The following 
discussion details the FSG's data bank and variable names, descriptions, 
units and source for each variable on the three historic data banks. 
Data Bank Names 
All data bank names have three components--the account number, a 
descriptive identifier, and a frequency identifier. (AJ1 data on any one 
bank must be of the same frequency, hence a separate bank is required for 
monthly, quarterly, and annual data.) The components of the data bank name 
are separated by periods and may not contain embedded blanks. 
1. Account Names--All of the general FSG central data banks will be 
maintained under account number "ERS@01." 
2. criptiv ntifier--The second part of the data bank name is a 
descriptive phrase to identify the contents of the bank. The 
phrase "USAG" will be used to describe a bank of historic U.S. 
agricultural data. 
3. Frequency identifier--The frequency of the observations is the 
third component of the name, and is specified as follows: 1/ 


1/ The WEFA/BOEING data management system can also handle semi-annual 
and weekly data as well as cross sectional series. 
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monthly = "MON" 

quarterly = "QTR" 

annual = "ANN" 
Hence, the following historic U.S. agricultural banks are currently 
on the system: 

ERS@91.USAG. ANN 

ERS@61.USAG.QTR 

ERS@@1.USAG.MON 
Unless otherwise indicated, all crop variables in the annual banks 
are quoted on a crop year basis (the individual crop years 
indicated in the title of the variable) and livestock variables on 
a calendar year. All variables in the quarterly banks, unless 
otherwise specified, are based on a calendar year quarter. 
Note that Wharton also maintains nonagriculturai data banks, 
information about which may be obtained by typing: 

LIST 'CXD@@1.BANKS.INFO' 
on the BOEING MAINSTREAM computer system or referring to WEFA data 
bank documentation manuels. 
Variable Names 

The name of a variable stored on a data bank may contain up to 15 
alphanumeric characters. In order to avoid a massive dictionary of 
variable names and definitions, a systematic procedure has been 
developed for naming variables. Nonagricultural data will be named 
following the Wharton conventions, but the name will be preceded by 
a period. Agricultural data will be identified as follows. 
The logic pense eAnaae convention was to provide variable 


names that would be d48 short as possible, could be easily 


deciphered, and would provide uniqueness. Thus, the variable names 


inal ivi we wl 
n ae ' ’ 
Hy is ba : : iy ys 
i : i. : y ¥ mis id ij 
| a Ai | i ? 
j Tie ed 
; | La 
} ieee 7 _ , 7 mS tome he _ 2%) is a : 
aisha ache ore enluind amis. 1: oteld prhwoliet emt ysoneh 
; 7 yee) 
eat : 
f kw ns 
he 


1331eup IAEY anbbatien 8 no eke one spertioege sae 


bined ssab sad Luokagensa oa. cas! ee 


ny ei 


af of qu oiedono. yam ainad sinh 8 "0 > bees 


ioeg 
- 


 yiaootsoth evyiecem « bicys ed: 39090) at uae 
if 

190d asd ertibend7q objenedeye + acleenea tt ash % 

<< oe 


1 aa nats | | 
; ue a - i ‘- vy an ery —— 
i A Ks ape a ie ae | y 
aWoitc? ex tata a ieee a! 


bemsn od fltw eteb teri ivoingenoh 


YO hebsoeng ed Iliw enar ss. tud’ 4 


os — * 
sidattay ’ abivesq 08 wont Ts ‘ wat 
ehh aa a ini 0 pat ’ a ol va 4, | fe lit - 
semen sSdalnnv a, gest yi. at 
ae a in 
it ae 


are broken into character fields which provide specific information 
about the statistic. Wherever possible alpha characters where used 
to help facilitate breaking down a name. The particular sequence 
of fields comprising a name were chosen so that given the U.S. 
aggregate type of data being placed on the banks, the names would 
be as short as possible. 

Historic Variables 
Ten of the fifteen characters of a historic variable name are 


broken into 6 fields of from one to three characters as illustrated 


below. 

F F F F F F 
a I i HN I I 
E E E E E E 
L L L ib L L 
D D D D D D 
1 2 3 ut 5 6 

Character 

Position ees 4 5 67 8 9 10 


Fields one, two, and three (columns 1 - 5) are generally all that will be 
required to reference data from the historic banks and the remaining fields 
may be left blank. Wherever one or more fields are not required to define 
a variable but are bordered on each side by character fields, a convention 
was adopted to place asterisks in the empty positions(s) since no name can 
have embedded blanks. 

be bag, h r 

Field one is the commodity (or aggregate) code derived as follows: 

1. If the commodity name consisits of one word, the first three 


letters of the word are used. (Note that conflicts may arise). 
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2. If the commodity name consists of two words the first two letters 

of the pei word and the first letter of the second word are used. 

3. If the commodity name consists of three words, the first letter of 

each word is used. 

Reference Sheat A presents tlie commodity and product codes based on the 
above seheme.. When a conflict occurs, an alternative code must be selected 
(e.g., COL is used for cotton). Note that field four is used to identify a 
particular grade or variety of a commodity. ecole Nesele of current 
commodity grade and variety codes are presented in Reference Sheet D. Also 
note that the codes on the reference sheets will be expanded as the need 
arises. 

Field 2 (1 character) 

Field two identifies the major type (or category) of statistic. For 
axanpies a price series is identified by a P. Reference Sheet B contains a 
listing of the major type of statistics and their associated codes. 

Field 1 r 

Field three is a qualifier to. the ‘major type of statistic. Thus P in 
field 2 may ive qualified by an F to indicate a farm price. This sub 
category descriptor is also listed on Reference Sheet B. 

Field 4 (2 characters) | 

Field Pour contains a description or qualifier to the basic commodity 
code. These grade or variety designators are included in Reference Sheet 
D. 

Field 5 (2 characters) 
Field five is a location fun pyar te may identify a country, state, 


city, region, etc. If the field is blank, the U.S. is assumed. Aggregate 
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exports and imports in the U.S. banks are assumed to be from or to the U.S. 
Location identifiers currently in use are presented on kKeference Sheet C. 
Field 6 (1 character) 

Field six provides an additional code for a grade or variety 
designation, but is currently not being used. It is anticipated that its 
chief use will be to delineate products at the retail level. 

Additional coding conventions 

Note that the last five characters of the possible fifteen are not 
being used. Additional coding conventions could be used to more adequately 
handle very specialized statistics that the FSG does not currently 
anticipate using but may be desirable at some later date. One additional 
convention has been adopted in order to allow a time series of a particular 
quarter on a variable to be placed on an annual bank. Thus, if one wanted 
a time series of the first quarter observations on a variable, the name 
adopted above would have appended on to its last character position a 1 
signifying ere first quarter (e.g., third quarter observations on the U.S. 
corn farm price would be increased by the name CORPF3). 

fe) V e 

Variables that will be placed on the forecast data banks will have 
slightly Bitened famine conventions. In fact, two unique coding schemes 
exist for the identification of forecast variables. The first convention 
facilitates analytical use of current forecasts while the second convention 
facilitates efficient storage of forecasts over time. 

Forecast Convention #1 
A four character forecast descripter containing three fields is 


appended on to the front of the historic name for which a forecast is being 
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made. The field specifications are: 


F F F 
if I ME 
E E E 
ib c L 
D D D 
1 2 3 

Character 

Position 1 2 3 4 


Field 1 (1 Character) 

This field contains one alpha character which deliniates the forecaster 
as well as the alternative sets of assumptions underwhich the forecasts 
were made. The outlook and eituation analysts base forecast is labeled by _ 
a B. The FSG cross commodity model base forecasts are labeled with an M 
and futures market forecasts are labeled with an F. Interagency Estimates 
Committee forecasts are identified- by an I. | | 

Leldrz ar r 

This field consists of one numberic digit which specifies in what 
calendar year quarter the forecasts were made. -If the forecasts for a 
variable were made during ‘the fourth Blertepnio7si 4 would be placed in. 
field two. Annual forecasts would have a 1 in this field eironets 
consistent with the WEFA/BOEING convention for an annual frequency. 

Field 2. char re | | | | 

This field has two numeric digits ies are the last. two digits of the 
year in which a forecast was made. A forecast made during 1975 would be 
indicated by 75 in character positions 3 and 4. 

Thus, a base set of forecasts on corn farm prices made during the 


fourth quarter of 1975 would be inputed in the appropriate forecast bank 
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under the name B475CORPF. CORPF is the historic name associated with the 
farm price of corn derived using the historic data naming conventions 
mentioned earlier. Because this naming convention through time produces a 
large number of variables with few observations, a second naming convention 
was adopted to retain forecasts on a historical perspective. 
Fore nvent #2 

A two character forecast descriptor with two fields of one character 
each is appended onto the front of the basic historic name for which a 
forecast is being made. 


The field specifications are: 


F F 
I , 
E E 
ib ib 
D D 
1 2 

Character 

Position 1 2 


Field 1 (1 character 

This field is exactly the same as the first naming convention, i.e., an 
indicator of the forecaster and assumptions underwhich the forecasts are 
made. B is the outlook and situation analysts base forecasts, M is the 
cross commodity model forecasts, F is the futures forecasts, I is 
Interagency estimates. 
Field 2 (1 character) 

This field indicates the lead time by which the forecast was made prior 
to the actual event. Hence a zero indicates the forecasts were made during 


the quarter being forecast. A 3 indicates the forecasts were made three 
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quarters before the actual event. 
With this convention, only four variables (eg. BOCOXPF, BICORPF, 
BZCORPF, and B3CORPF) are required to identify all forecasts of a variable 


that are normally produced via the quarterly memo analysis. 


REFERENCE SHEET A 
COMMODITY CODES 


COMMODITY COMMODITY NAME 
ABBREVIATION 1/ 
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NONAGRICULTURAL DATA-- 
USE WHARTON CONVENTIONS PREFIXED BY A PERIOD "." 


1/ A three digit specification of a commodity name entered into the 
first three digits of the variable code name. In general, (1) when 
a commodity name is expressed in one word, use the first three letters, 
(2) if there are two words, use the first two letters of the first name 
and the first letter of the second name, and (3) if there are three 
words, use the first letter of each word. 

2/ Including poultry. 
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Total domestic disappearance ....... D 
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1/ Major data type code is entered in the fourht posiiton of the 
variable code name. 

2/ Subcategory of data type code is entered in the fifth position of the 
variable code name. 

3/ A standard convention has yet to be established. This will be 
dependent upon the ratios to be maintained on the bank. Generally, the 
first character of the commodity will be used, but numeric codes will be 
required where conflicts arise. The commodity placed in the numerator is 
delineated in the first three characters of the variable code name. 
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1/ Two digit alphabetic State name abbreviation entered into the eighth 
nd ninth positions of the variable code name. These abbreviations are 
consistent with the Federal Information Processing Standards (FIPS), ex- 
cluding Mexico and Canada. except for Nebraska and Delaware. 

2/ Use blanks if there are no codes in the tenth through fifteenth positions 
of the variable name. Use two asterisks is one or more codes are contained 
in the tenth through the fifteenth positions. 
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COMMODITY 


CROPS 


Alfalfa 

Alfalfa, baled 
Barley 

Beans, dry edible 
Cigarettes 

Corn 

Corn, grain 

Corn, products 
Corn #2 yellow 


Cotton lint, American Pina 
Cotton lint, American upland 


Cottonseed 
Flaxseed 

Hay 

Hay, all baled 
Oats 

Oats, grain 
Pasture 

Peanuts 
Potatoes 

Rice 

Rye 

Sorghum 
Sorghum, forage 
Sorghum, grain 
Sorghum, silage 
Soybeans 
Soybeam meal 
Soybean Oil 
Sweetpotatoes 
Tobacco 
Tobacco, burley 


Tobaceo, flue cured 


Wheat 

Wheat, flour 
Wheat, grain 
Wheat, products 


AGGREGATE 
* Crops, all 


Dairy 
Feed grains 


~ Feed 


Fibers 
Food grains 
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GRADE, VARIETY, ETC. 
DESIGNATION 2/ 
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Fruits 

Livestock, all 3/ 
Livestock and crops, all 
Meat 

Poultry 

Poultry, other 
Fluid products 
Fluid products, inc. 
Vegetables 


imitation 


LIVESTOCK, POULTRY, AND PRODUCTS 


Barrows and gilts 

Beef, all 

Beef, cows 

Beef, heifers 

Beef, steer 

Beef, fed 

Beef, nonfed 

Beef and veal 

Bulls 

Bulls, 500 pounds and over 
Butter 

Calf, (calves) 

Calves, less than 500 pounds 
Cattle 

Cattle, feeder 

Cattle, fed 

Cattle, nonfed 

Cattle and calves 

Cheese 

Cheese, American 

Cheese, Swiss 

Cheese, other 

Cheese, cheddar 

Cheese, processed 
Chickens, (chicks) 
Chickens, egg type 
Chickens, broiler type 
Chickens, young 

Chickes, mature 

Chickens, other 

Chickens, frying 

Chickens, other, excl. broilers 
Chickens, exl. broilers 
Cows 

Cows, bee!’ 

Cows, canner and cutter 
Cows, milk 

Cows, milk, 2 yrs & over 
Cows, milk, 1-2 yrs. 

Cows, utility 

Cows and heifers 

Cows and lieifers, beef cows 
Cows and leifers, beef, nonfed 
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Cows and heifers, milk cows 

Cows and heifers, milk nonfed 

Eggs 

Eggs, shell 

Eggs, frozen 

Ewes 

Ewes, one year and older 

Goats 

Heifers 

-Heifers, replacements 

Heifers, beef cow replacements 
500 pounds and over 

Heifers, milk cow replacements 
500 pounds and over 


Heifers, other, 500 pounds and over 


Heifers kept for milk 


Heng <m, 

‘Hens, breeder 
"Hens, potential layers 
Hens and pullets 


Hens and pullets, potential layers 


Hogs 

Hogs and pigs 

Horses 

Lambs 

Lamb and mutton 

Lard 

Milkfat in cream 

Milk 

Milk, butterfat 

Milk, dry 

Milk, evaporated 

Milk, frozen products 

Milk, evaporated skim 

Milk, condensed sweetened 
Milk, condensed unsweetened 
Milk, condensed skim 

Milk, evaporated buttermilk 
Milk, nonfat dry 

Milk, unsweetened evaporated 
Milk, dry, animal feed 
Milk, all 2ondensed 

Milk, evaporated and condensed 
Milk, lowfat 

Milk, crean mixtures 

Milk, whol > 

Milk, ice -ream 

Milk, skim 

Milk, cond :nsed, exclu. ice cream 
Mohair 

Pigs 

Pork 

Pullets 

Pullets, li ying age 
Pullets, 3 months and over 
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Not of laying age PUL eae ewe (fh he eae Siete gies St 


Pullets, under 3 months PUL Cie os Sete Beles s car ip shea? & eheioee moe 
Poults POL 
Poults, heavy POL Sess 2 cine aie abi a ep ge es | 
Poults, light POL atone ia ahaha OF oP es oe Sate ogg bi 
Rams RAM 
Sheep SHE 
Sheep and lambs SAL 
Sheep and lambs, stock Sh) A tk: or ae ST 
Sheep and lambs, on feed DAL. en om Wis Mate Sale Bie os oP FE 
Sows SOW 
Stags and boars SAB 
Steers and heifers SAH 
Steers and heifers, fed DAH es aie e Fa Pieleisieie ois § % FD 
Steers and heifers, nonfed DAH Mes cise einia, <3 belt ieiele tie vida UNE. 
Steers STE 
Steers, 500 pounds and over DED eas cle ¢ «us ae bwleteis > ¢ ~ + 
Steers, heifers, bulls SHB 
Steers, heifers, bulls, fed S12, JAAS ay, Seti Pater Bieta a 
Steers, heifers, bulls 

under 500 pounds Po) RE A ae Age ae 2S, top Bele 
Turkeys TUR 
Turkeys, heavy breed CUR OSes ol tete 6 nace eae ete Ale 
Turkeys, light breed AN ear gO ee be  -iite Br fetes @ LB 
Veal VEA 
Wethers WET 
Wethers and lambs WAR 
Wool WOO 
Wool, apparal WOU se sty ae see ace pidisie Bes AF 
Wool, carpet WOU" ES cote olste ® ar BoXp atetere 2 wore Gr 
Wool, shorn Were eg hee cesta a oles ows crore vata SH 
Wool, pulled WODB a. . ss ate ts o's Cake oe a Aes ed AE 


NONAGRICULTURAL DATA- 
USED WHARTON CONVENTIONS PREFIXED BY A PERIOD 


i/ A three digit specification of a commodity name entered into the 
irst three digits of the vairable code name. In general, (1) when a 
commodity name is expressed in one word, use the first three letters, 

(2) if there are two words, use the first two letters of the first name 
and the first letter of the second name, and (3) if there are three words, 
use the first letter of each word. 

2/ The grade, variety, ect. designation is a two digit alphanumeric 
code entered into the sixth and seventh position of a variable name. It 
is used to further delineate a major commodity name abbreviation. 

3/ Including poultry. 
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